home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / getdomainname.z / getdomainname
Encoding:
Text File  |  2002-10-03  |  2.7 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttddddoooommmmaaaaiiiinnnnnnnnaaaammmmeeee((((2222))))                                              ggggeeeettttddddoooommmmaaaaiiiinnnnnnnnaaaammmmeeee((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      getdomainname, setdomainname - get/set name of current NIS domain
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiinnnntttt ggggeeeettttddddoooommmmaaaaiiiinnnnnnnnaaaammmmeeee((((cccchhhhaaaarrrr ****nnnnaaaammmmeeee,,,, iiiinnnntttt nnnnaaaammmmeeeelllleeeennnn))));;;;
  13.      iiiinnnntttt sssseeeettttddddoooommmmaaaaiiiinnnnnnnnaaaammmmeeee((((cccchhhhaaaarrrr ****nnnnaaaammmmeeee,,,, iiiinnnntttt nnnnaaaammmmeeeelllleeeennnn))));;;;
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _G_e_t_d_o_m_a_i_n_n_a_m_e returns the name of the NIS domain for the current host, as
  17.      previously set by _s_e_t_d_o_m_a_i_n_n_a_m_e.  The parameter _n_a_m_e_l_e_n specifies the
  18.      size of the _n_a_m_e array.  The returned name is null-terminated unless
  19.      insufficient space is provided.
  20.  
  21.      _S_e_t_d_o_m_a_i_n_n_a_m_e sets the NIS domain of the host to be _n_a_m_e, which has
  22.      length _n_a_m_e_l_e_n.  This call is restricted to the superuser and is normally
  23.      used only during system initialization.
  24.  
  25.      The purpose of NIS domains is to enable two distinct networks that may
  26.      have hostnames in common to merge.  Each network would be distinguished
  27.      by having a different NIS domain name.
  28.  
  29. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  30.      If the call succeeds a value of 0 is returned.  If the call fails, then a
  31.      value of -1 is returned and an error code is placed in the global
  32.      variable _e_r_r_n_o.
  33.  
  34. EEEERRRRRRRROOOORRRRSSSS
  35.      The following errors may be returned by these calls:
  36.  
  37.      [EFAULT]       The _n_a_m_e parameter gave an invalid address.
  38.  
  39.      [EPERM]        The caller was not the superuser.  This error only applies
  40.                     to _s_e_t_d_o_m_a_i_n_n_a_m_e.
  41.  
  42. BBBBUUUUGGGGSSSS
  43.      NIS domain names are limited to 64 characters.
  44.  
  45. NNNNOOOOTTTTEEEE
  46.      This call is provided for backward compatibility with pre-IRIX 5.0
  47.      applications.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.